home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 4 / Shareware Extravaganza - Over 25,000 Programs (The Ultimate Shareware Company)(Disc 4 of 4)(1993).iso / cad / cmenu13.zip / CMENU.DOC < prev    next >
Text File  |  1990-08-26  |  17KB  |  553 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                  Custom#Menu, copyright (c) 1990 by Mountain Software
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                      Custom#Menu
  20.  
  21.  
  22.  
  23.                            AutoCAD Menu Customizing Utility
  24.                                      Version 1.3
  25.                                    August 26, 1990
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                  Jerry Workman, P.E. 
  33.                                  1579 Nottingham Road
  34.                                  Charleston, WV 25314
  35.                                    CIS 70717,3564 
  36.  
  37.  
  38.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                   Table of Contents
  46.  
  47.  
  48.  
  49.      I    U s i n g   C u s t o m # M e n u  . . . . . . . . . . . . . . . .   3
  50.           Purpose  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  51.           Installation . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  52.           Running Custom#Menu  . . . . . . . . . . . . . . . . . . . . . . .   4
  53.           Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  54.  
  55.      II   A d d e n d u m  . . . . . . . . . . . . . . . . . . . . . . . . .   7
  56.           Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  57.           Suggestions  . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  58.           Liability  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  59.           Author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  60.  
  61.      III  L i c e n s e  . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  62.           Registration Information . . . . . . . . . . . . . . . . . . . . .   9
  63.           Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  64.           Trademark  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  65.           Site Licenses and Quantity Purchases . . . . . . . . . . . . . .    10
  66.           Revision History . . . . . . . . . . . . . . . . . . . . . . . .    10
  67.  
  68.  
  69.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  70.  
  71.  
  72.      I    U s i n g   C u s t o m # M e n u
  73.  
  74.      Purpose
  75.      -------
  76.  
  77.      The  AutoCAD menu system  can be a  powerful user interface  to the AutoCAD
  78.      drawing  editor  and for  custom  applications.  Modifying  the  menus  is,
  79.      however,  not easily accomplished. The menu files must be modified using an
  80.      ASCII editor  external to  AutoCAD. It is  difficult to locate  the precise
  81.      location of tablet menu items, and the menu language is somewhat cryptic.
  82.  
  83.      Custom#Menu is a utility that provides the ability to an inexperienced user
  84.      to easily modify an AutoCAD menu. Custom#Menu runs from within the  drawing
  85.      editor, the  user can  pick the  location of  menu items  using a  mouse or
  86.      digitizer  pointer, and  assistance is  provided  in constructing  the menu
  87.      command. Buttons, tablet boxes, first level popup, and the main screen menu
  88.      items can be added, inserted, or deleted.
  89.  
  90.      Custom#Menu is  executed through  an  AutoLisp program  (CMENU.LSP) and  an
  91.      external executable  program (CMENU.EXE). Custom#Menu  works on any  IBM PC
  92.      compatible computer capable of running AutoCAD.
  93.  
  94.  
  95.      Installation
  96.      ------------
  97.  
  98.      Custom#Menu can be used to install itself as follows:
  99.  
  100.      First, make a backup copy of ACAD.MNU and other menus files that you intend
  101.      to modify. 
  102.  
  103.           NOTE: The  menu source file (eg  ACAD.MNU) _MUST_ be in  the same
  104.           directory as the compiled menu file (eg ACAD.MNX) for Custom#Menu
  105.           to work. CMENU.EXE modifies the .MNU file.
  106.  
  107.      Copy the CMENU files from  the distribution diskette (or extract  them from
  108.      the archive file) to your AutoCAD subdirectory, or to sub-directories where
  109.      DOS and AutoCAD can find them. CMENU.EXE can be in any directory that is on
  110.      the DOS PATH. CMENU.LSP and  INSTALL.SCR must be in a directory that  is in
  111.      the AutoCAD library path. If you are not sure of your DOS or AutoCAD paths,
  112.      place both files in the same directory as ACAD.EXE (usually C:\ACAD).
  113.  
  114.      Load AutoCAD, and enter the drawing editor.
  115.  
  116.      Enter the following from the AutoCAD Command prompt:
  117.  
  118.      Command: SCRIPT INSTALL
  119.      Pick Tablet, Button or Screen Menu Location with cursor... <pick location>
  120.  
  121.      CMENU.EXE will now execute and  insert the new menu item. You may also move
  122.      the Cmenu command to another location (using Cmenu) later if you wish.
  123.  
  124.           NOTE:     The AutoCAD command  SHELL must work so  that CMENU.EXE
  125.                     can execute.
  126.  
  127.  
  128.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  129.  
  130.  
  131.      Running Custom#Menu
  132.      -------------------
  133.  
  134.      If you have  installed Custom#Menu  select it from  the AutoCAD menu,  else
  135.      load and run CMENU.LSP from the Command: prompt. 
  136.  
  137.      eg:
  138.      Command:(LOAD"CMENU")
  139.      Command:CMENU
  140.  
  141.      Follow the prompts to:
  142.  
  143.      1 -  Select the location of the menu item to modify:
  144.  
  145.      Pick Tablet, Button or Screen Menu Location with cursor... <pick location>
  146.  
  147.           You may select a location from  any of the popup menus, the  main
  148.           screen menu, any pointer device button or any tablet location.
  149.  
  150.      2 - If a popup or screen menu was selected:
  151.  
  152.      Add/Insert/Overwrite/Delete[I]:
  153.  
  154.           Enter:    A - to add the item to the bottom of the menu list or..
  155.                     I - to insert above the selected location or..
  156.                     O - to overwrite (replace) the selected item or..
  157.                     D - to delete the item.
  158.  
  159.      3 - If Add, Insert, or Overwrite is selected:
  160.  
  161.      Enter menu title:
  162.  
  163.           Enter a name or short description for this item.
  164.  
  165.                This is the title displayed  on popup and screen menus.
  166.                For button  and  tablet menus  it serves  as a  keyword
  167.                label  to describe  or document the  menu item  in your
  168.                menu file.
  169.  
  170.      4 - AutoLisp/Insert block/Command[<default>]:
  171.  
  172.           Enter:    A - to load and run an AutoLisp program.
  173.                     I - to insert a block.
  174.                     C - to enter an AutoCAD command.
  175.  
  176.           The last  used  mode is  displayed  as the  default  and will  be
  177.           selected if you press <SPACE> or <ENTER>.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.      Chapter 1, Using Custom#Menu                                         Page 4
  187.  
  188.  
  189.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  190.  
  191.  
  192.      5 - If AutoLisp is selected:
  193.  
  194.      Autolisp filename:
  195.  
  196.           Enter  the  filename  of  the  lisp  program  without   the  .LSP
  197.           extension.    (eg    LEXPLODE   or    C:/ACAD/LISP/LEXPLODE    or
  198.           C:\\ACAD\\LISP\\LEXPLODE).
  199.  
  200.      Autolisp command to execute:
  201.  
  202.           Enter the command  the executes the program (usually  the same as
  203.           the filename but not always).
  204.  
  205.  
  206.      6 - If Insert is selected:
  207.  
  208.      Block name[<lastblk>]:
  209.  
  210.           Enter the name of the block to insert, the name of the last block
  211.           accessed is displayed, and used if a blank line is entered.
  212.  
  213.      7 - If Command is selected:
  214.  
  215.      ^C^C = Cancel, ^P = Toggle menuecho, ; = Return, \ = Pause for input
  216.      Enter menu command: 
  217.  
  218.           Enter any valid  AutoCAD command. Note that in a  menu spaces are
  219.           significant  and that  the following  characters  have a  special
  220.           effect:
  221.  
  222.           *    repeat command until <Ctrl><C> is pressed
  223.           ^C   cancel
  224.           ^P   turn off echo of menu commands
  225.           ;    same as <Enter>
  226.           \    pause for user input
  227.  
  228.           Example: *^C^C^PINSERT DOOR;\;;\
  229.  
  230.           This  would cancel  any pending  commands, insert  a block  named DOOR
  231.           pause for the user  to enter the location, accept the  default X and Y
  232.           scale, and pause for rotation angle. The command would not echo to the
  233.           screen and repeat until <CTRL><C> is pressed.
  234.  
  235.           See appendix B.4 of the AutoCAD reference manual.
  236.  
  237.      Once the prompts are completed, the AutoLisp  program will shell to DOS and
  238.      execute CMENU.EXE  which will  create a  backup file of  the existing  menu
  239.      named OLDMENU.MNU  and then  modify the menu  file. The  menu file  will be
  240.      compiled and reloaded when AutoCAD returns.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.      Chapter 1, Using Custom#Menu                                         Page 5
  248.  
  249.  
  250.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  251.  
  252.  
  253.      Limits
  254.      ------
  255.  
  256.      Custom#Menu can not be used  to alter screen menus  (the menu on the  right
  257.      side  of the display) below  the first level. Nor can  it alter popup menus
  258.      below the first level. It can not create  a new menu or submenu. It can not
  259.      create  or edit an icon menu. Menu commands  are limited to one line. These
  260.      features may be added in future releases.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.      Chapter 1, Using Custom#Menu                                         Page 6
  309.  
  310.  
  311.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  312.  
  313.  
  314.      II   A d d e n d u m
  315.  
  316.  
  317.      Error Messages
  318.      --------------
  319.  
  320.      Error - Invalid type code
  321.  
  322.           Reason:   An invalid type code was read from the file CMENU.DAT.
  323.  
  324.      Error - Cannot open file XXXX
  325.  
  326.           Reason: Disk error (possibly full), corrupted or missing CMENU.DAT.
  327.  
  328.      Error reading parameter file
  329.  
  330.           Reason: Unexpected error or end of file reading CMENU.DAT.
  331.  
  332.      Error - Unable to open menu file
  333.  
  334.           Reason: Disk error or corrupted CMENU.DAT
  335.  
  336.      Error locating target - **POP4
  337.  
  338.           Reason: CMENU.DAT or the menu file may be corrupted.
  339.  
  340.      Error closing menu file - ACAD.MNU
  341.  
  342.           Reason: Disk error (usually disk full).
  343.  
  344.      Error flushing temporary menu file buffer XXXX
  345.  
  346.           Reason: Disk error (usually disk full).
  347.  
  348.      Error closing temporary menu file XXXX
  349.  
  350.           Reason: Disk error (usually disk full).
  351.  
  352.      Error renaming file - XXXX
  353.  
  354.           Reason: Disk error or file is read only.
  355.  
  356.      Error renaming temporary menu file - XXXX
  357.  
  358.           Reason: Disk error or menu file is read only.
  359.  
  360.      Error reading menu file at line X
  361.  
  362.           Reason: Unexpected end of file encountered or Disk error.
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.      Chapter 1, Using Custom#Menu                                         Page 7
  370.  
  371.  
  372.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  373.  
  374.  
  375.      Suggestions
  376.      -----------
  377.  
  378.      Make  your own  custom menu  system  with Custom#Menu.  Duplicate the  file
  379.      ACAD.MNU by  copying to a  new file.  (eg COPY ACAD.MNU  MYCUST.MNU) Modify
  380.      this (and others if you wish) for each application or users preference.
  381.  
  382.      Experienced users and developers will find Custom#Menu a useful development
  383.      tool. Menus can be modified "on the fly" thus making testing  and debugging
  384.      fast and easy.
  385.  
  386.  
  387.      Liability
  388.      ---------
  389.  
  390.      This  program modifies  and deletes  portions of  your menu  files! Careful
  391.      testing  has been made  to ensure that the  processes perform correctly. No
  392.      liabilities are  assumed in the use or misuse  of this program resulting in
  393.      data loss  or damage. It  is the users responsibility  to be sure  that the
  394.      results are as expected.
  395.  
  396.  
  397.      Author
  398.      ------
  399.  
  400.      If you have any suggestions or comments, please contact me.
  401.  
  402.      Jerry Workman, PE
  403.      1579 Nottingham Rd.
  404.      Charleston, WV 25314 
  405.      CIS 70717,3564
  406.      304-744-7748 (after 7:30 ET)
  407.  
  408.      Copyright (c) 1990, by Mountain Software All rights reserved 
  409.  
  410.  
  411.      III  L i c e n s e
  412.  
  413.  
  414.      Shareware
  415.      ---------
  416.  
  417.      This version of Custom#Menu  is NOT public domain or free  software, but is
  418.      being distributed as "shareware". You may try it out to see if it is useful
  419.      for you. If  you wish to continue  to use Custom#Menu you  may purchase the
  420.      commercial version. The commercial version  of the program will be provided
  421.      which does not contain the opening delay. 
  422.  
  423.      The program in the  form of the original archived  file only may be  freely
  424.      distributed, but not sold (except  under license, or for a nominal  copying
  425.      charge).
  426.  
  427.      Non-registered users of  this software are granted a limited 14 day license
  428.      to  make an evaluation  copy for trial  use for the  purpose of determining
  429.  
  430.      Chapter 2, Addendum                                                  Page 8
  431.  
  432.  
  433.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  434.  
  435.  
  436.      whether Custom#Menu is suitable  for their needs. At the end  of this trial
  437.      period,  you  should  either  register  your  copy,  or  discontinue  using
  438.      Custom#Menu.
  439.  
  440.      All users are  granted a limited license  to copy Custom#Menu only  for the
  441.      trial use of others and subject to the above limitations. This license does
  442.      NOT include distribution or copying of this software for use:
  443.  
  444.      1.   In connection with any other product or service.
  445.      2.   For general use within a company or institution.
  446.      3.   For distribution  in modified  form; i.e.,  the  file containing  this
  447.           license information MUST be included,  along with the full Custom#Menu
  448.           documentation.
  449.  
  450.      Operators of electronic  bulletin board systems (Sysops) are  encouraged to
  451.      post  CMENUxx.ZIP  for  downloading  by  their  users,  as  long  as  these
  452.      conditions are met.
  453.  
  454.  
  455.      Registration Information
  456.      ------------------------
  457.  
  458.      A Custom#Menu  registration licenses you  to use the  product on  a regular
  459.      basis.  Individual license  cost  for  Custom#Menu is  $30  for the  latest
  460.      Custom#Menu  diskette (with the delay  removed). Commercial license cost is
  461.      $50 per copy. West Virginia residents should include 6% sales tax.
  462.  
  463.      Educational institutions, full-time students and BBS sysops can apply a 50%
  464.      discount. PLEASE include your educational institution letterhead (with your
  465.      title), or  a photocopy of your most recent  registration slip, or the name
  466.      and number of your BBS.
  467.  
  468.  
  469.      Disclaimer
  470.      ----------
  471.  
  472.      Use of this program acknowledges this disclaimer of warranty: "This program
  473.      is supplied as is. Mountain Software disclaims all warranties, expressed or
  474.      implied,  including, without limitation,  the warranties of merchantability
  475.      and of  fitness of this program for  any purpose. Mountain Software assumes
  476.      no liability for damages direct or consequential, which may result from the
  477.      use of this program."
  478.  
  479.  
  480.      Trademark
  481.      ---------
  482.  
  483.      Mountain  Software and  Custom#Menu are  trademarks  of Mountain  Software.
  484.      MS-DOS  is a  registered trademark  of Microsoft  Corporation. PC-DOS  is a
  485.      registered trademark of IBM Corporation. AutoCAD is a  registered trademark
  486.      of AutoDesk.
  487.  
  488.  
  489.  
  490.  
  491.      Chapter 3, License                                                   Page 9
  492.  
  493.  
  494.      Custom#Menu for AutoCAD                           User's Guide, version 1.3
  495.  
  496.  
  497.      Site Licenses and Quantity Purchases
  498.      ------------------------------------
  499.  
  500.      All   corporate,  business,  government   or  other  commercial   users  of
  501.      Custom#Menu must be registered. We offer quantity discounts as well as site
  502.      licensing.
  503.  
  504.      Corporate site licensing  agreements allow duplication and  distribution of
  505.      specific numbers of copies within the licensed  institution. Duplication of
  506.      multiple  copies is  not allowed  except through  execution of  a licensing
  507.      agreement. Site license fees are based upon estimated number of users.
  508.  
  509.      Note that with a site license, only  one copy of the program will be  sent.
  510.      You will be responsible for distributing additional copies.
  511.  
  512.      Please write for more information.
  513.  
  514.  
  515.      Revision History
  516.      ----------------
  517.  
  518.      Version 1.0 (7/1/90)
  519.  
  520.      .    Original release
  521.  
  522.      Version 1.1 (7/6/90)
  523.  
  524.      .    Bug fix, AutoCAD  internal subroutine TYPE was being  overwritten by a
  525.           CMENU variable.
  526.  
  527.      Version 1.2 (7/28/90)
  528.  
  529.      .    AutoCAD menus on different disk drives can now be modified
  530.      .    Fixed popup submenu bug. Popup menus are now popped one level prior to
  531.           user location  select, and  CMENU.EXE properly  finds the  first level
  532.           popup menu.
  533.  
  534.      Version 1.3 (8/26/90)
  535.  
  536.      .    General streamlining - CMENU.LSP and CMENU.EXE now run faster.
  537.      .    Documentation revisions
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.      Chapter 3, License                                                  Page 10
  553.